home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / asm_n_z.zip / SDDOS.DOC < prev    next >
Text File  |  1988-01-29  |  31KB  |  802 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                                    Switch Directory
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                   Stephen M. Falatko
  59.                                  Copyright 1987, 1988
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                 Table of Contents
  68.  
  69.  
  70.  
  71.             Introduction . . . . . . . . . . . . . . . . . . . . . . . . . .    3
  72.  
  73.             Available Commands   . . . . . . . . . . . . . . . . . . . . . .    3
  74.  
  75.             Acknowledgement  . . . . . . . . . . . . . . . . . . . . . . . .    5
  76.  
  77.             Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  78.  
  79.             The Configuration File . . . . . . . . . . . . . . . . . . . . .    8
  80.  
  81.             Caveats and Other Things . . . . . . . . . . . . . . . . . . . .    9
  82.  
  83.             Error Messages . . . . . . . . . . . . . . . . . . . . . . . . .   10
  84.  
  85.             Errorlevel and Batch Files . . . . . . . . . . . . . . . . . . .   11
  86.  
  87.             Changing the Internal Name of SD . . . . . . . . . . . . . . . .   11
  88.  
  89.             License  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  90.  
  91.             Update Notes . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.       Introduction
  102.       ------------
  103.  
  104.             Switch  Directory  -  DOS  (SD)  is  a utility that allows easy
  105.             switching between subdirectories and  drives with  a minimum of
  106.             typing.   SD has  been designed  to replace  the DOS CD command
  107.             while providing enhancements to the CD command.   SD allows you
  108.             to  specify  a  specific  subdirectory  name,  a combination of
  109.             subdirectory names  and  search  switches  or  a  complete path
  110.             specifier.   All features  of SD work  across disk  drives.  If
  111.             you have made a mistake, hitting Ctrl-Brk while SD is searching
  112.             will   break you out of SD and put you back in the subdirectory
  113.             you started in.
  114.  
  115.             Switch Directory - DOS 1.0 is descended from SD version 3.4 and
  116.             its predecessors.   The  improvement in SD is that SD - DOS can
  117.             attach  itself  to  DOS  and  provide  the  same  functionality
  118.             previously only  available with  SD in combination with PCED or
  119.             CED.  For users of PCED or CED, an enhanced  version of  SD 3.4
  120.             is available called Switch Directory - CED.
  121.  
  122.       Available Commands 
  123.       ------------------
  124.  
  125.            [blank]            - Display current path
  126.  
  127.            \                  - Return to root directory
  128.  
  129.            \[path]            - Switch to the specified path
  130.  
  131.            /[subdirectory]   -  Search   below    the   current   directory   for
  132.                                 'subdirectory'
  133.  
  134.            ?                  - Display help  information (if  not installed with
  135.                                 the [+ command)
  136.  
  137.            ..                 - Back up one directory
  138.  
  139.             Combinations of  \ and / may be used to increase the speed of  
  140.               searching while still reducing the required typing.
  141.  
  142.             All commands work across drives with the exception  of the show
  143.               path command.  SD is NOT case sensitive.
  144.  
  145.  
  146.            +                  - Loads  SD  without  help. (Using this combination
  147.                                 saves almost 1K of memory) 
  148.  
  149.            -                  - Loads SD without the stack  feature.  (Using this
  150.                                 combination saves over 600 bytes of memory)
  151.  
  152.                                                   3
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.            d:\dos\sd.cfg      - The file is a configuration file for the internal
  160.                                 stack.   By  using  a  configuration  file  it is
  161.                                 possible to pre-load the stack at startup, making
  162.                                 the  stack  feature  much  easier  to  use.   The
  163.                                 configuration file is an ascii file consisting of
  164.                                 ten lines formatted as shown:
  165.  
  166.                                      0=D:\DOS
  167.                                      1=D:\DOS\TURBO
  168.                                      .                               
  169.                                      .                              
  170.  
  171.                                 The file  names  can  be  in  any  case  but MUST
  172.                                 include the  full drive and path specifier.  Each
  173.                                 line must  be terminated   by  a carriage return-
  174.                                 line feed  sequence.  Most wordprocessors or text
  175.                                 editors  can  output  an  appropriate  file.   If
  176.                                 something is  wrong with the file SD will let you
  177.                                 know.
  178.  
  179.                       NOTE:       The  + and  - commands  can be  combined on the
  180.                                 command line.   The only requirement is that they
  181.                                 be immediately after SD.
  182.  
  183.            "0                 - switch to stack path 0 (the zero may  be replaced
  184.                                 with any number 0-9)
  185.  
  186.            "0=[path]          - set stack  path 0  to [path].  [path] may contain
  187.                                 drive specifiers.  In  this  way  you  can switch
  188.                                 between drives as well as paths.
  189.  
  190.            "0=[blank]         - clear  stack   path  0  ([blank]  means  a  space
  191.                                 character)
  192.  
  193.            "0=@               - set stack path 0 to the current path.
  194.  
  195.            "s (or S)          - show the current stack contents.
  196.  
  197.            "+                 - switch to the next available higher  stack entry.
  198.                                 (for example, if you have switched to stack entry
  199.                                 3, "+ will switch you to  the next  higher filled
  200.                                 entry be  it 4,  5, 6...  "+ will wrap if none of
  201.                                 the higher entries contain paths)
  202.  
  203.            "-                 - switch to the next available lower  stack entry. 
  204.                                 (will wrap around in the same fashion as "+)
  205.  
  206.            @                  - switch to  'home'.   That is,  switch to the last
  207.                                 directory selected with a "+, "- or "# command.
  208.  
  209.            @"                 - remove SD from memory.
  210.  
  211.                                                   4
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.       Acknowledgement
  219.       ---------------
  220.  
  221.             I would like to thank Jack Kilday, sysop of Northern Lights BBS  in  
  222.              Maine  for   his  efforts   Beta  testing   SD  and  his  ideas  for
  223.             improvements.  Thanks also  go to  Eric Isaacson,  author of  A86 for
  224.             some  coding  tips.  Chris  Dunford  provided  suggestions  regarding
  225.             interactions with PCED and planted the  seeds which  encouraged me to
  226.             add the  'stack' feature.   Thanks to Jerry Gray for pointing out the
  227.             problem with subdirectories that  have extensions.   James  Bach gets
  228.             the thanks for suggesting the hidden subdirectory search.
  229.  
  230.       Examples
  231.       --------
  232.  
  233.         Suppose your hard disk directory looked something like this:
  234.  
  235.                 [Root]------DOS---|---DISKUTIL
  236.                                   |
  237.                                   |---TURBO--|--SOURCE
  238.                                   |          |
  239.                                   |          |--TOOLS
  240.                                   |
  241.                                   |---WORDPERF
  242.  
  243.             Then, if we wanted to switch to this drive we could use:
  244.  
  245.            SD d:              - Would change  the active  drive to d: and put you
  246.                                 in the default directory which we  will assume is
  247.                                 the [Root]  directory (this  is similar to typing
  248.